home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / GNU / gnuplot.lha / gnuplot / docs / fit / readme.1st < prev   
Encoding:
Text File  |  1994-01-17  |  4.5 KB  |  130 lines
  1. Welcome to GNUFIT - an extension to GNUPLOT
  2. ===========================================
  3.  
  4. Version 1.2
  5.  
  6. gnuplot has been widely established as a powerful tool to do data and
  7. function plots. For the scientific use one additionally often needs
  8. a nonlinear least squares fitting procedure to combine a model function
  9. to measured data. This is introduced by GNUFIT. GNUFIT is a real extension
  10. of GNUPLOT that means, it covers all features of GNUPLOT and adds some new
  11. ones.
  12.  
  13. GNUFIT incorporates a nonlinear least squares fit mechanism into GNUPLOT. The
  14. fit uses the Marquardt-Levenberg-algorithm for fitting and the GNUPLOT
  15. function evaluation mechanism for calculation. Thus it remains relatively
  16. small. It offers all advantages of fitting every rather complex-formulated
  17. function you can create with GNUPLOT (including complex calculation).
  18.  
  19.  
  20. GNUFIT is available as follows:
  21.  
  22.     gnufit12.tar.gz     All new sources and diff's against gnuplot3.4 and
  23.             gnuplot3.5, readmes, demos and installation hints
  24.             needed to compile and run GNUFIT on your machine,
  25.             provided that you already have the original
  26.             gnuplot sources.
  27.  
  28.     gft12dos.zip    DOS executables 
  29.  
  30.  
  31. The files may be downloaded by anonymous ftp from
  32.  
  33.     dartmouth.edu
  34.     129.170.16.4
  35.     /pub/gnuplot
  36.  
  37.  
  38. A description of the files in gnufit12.tar.gz
  39. =================================================
  40.  
  41. readme.1st    This file - Overview
  42. compile.fit    Some hints for the compilation on various platforms
  43. install     UNIX shellscript to do the patches
  44. install.bat    DOS Batchfile for the same purpose
  45. credits     A list of people who helped me making GNUFIT stable
  46.  
  47. fit.c        the main fitting routines
  48. fit.h        Interface to fit.c
  49. matrix.c    some matrix algebra needed in fit.c
  50. matrix.h    interface to matrix.c
  51. type.h        commonly used types
  52. linux.trm    terminal driver for LINUX
  53.  
  54. patches.35     Context diff's of the GNUFIT sources against the GNUPLOT3.5
  55.         sources. They have been done using
  56.         diff -cr oldfile newfile >> patches.35
  57.         and may be applied to the gnuplot sources by the patch program.
  58.         This is done also by the install-script.
  59. patches.34    Same story based on gnuplot3.4 for the case of incompatibilities
  60.  
  61.  
  62.  
  63. Installation procedure:
  64. =======================
  65.  
  66.  
  67. 1)  Start from the directory */diff which has been generated by untaring
  68.     this package.
  69.  
  70. 2)  Create a directory (e.g. called 'gnufit') and place a copy of the gnuplot3.2
  71.     sources (including the subdirs) in it. Make sure that it is writable.
  72.     gnuplot sources may be obtained from ftp.dartmouth.edu in
  73.     /pub/gnuplot
  74.  
  75. 3)  If you're not working under DOS or UNIX, create an appropriate
  76.     scriptfile like has been done in 'install' (UNIX) or 'install.bat' (DOS).
  77.     The only commandline-parameter of the scriptfile is the directory you
  78.     just created (gnufit).
  79.  
  80. 4)  Execute the scriptfile. This will copy the necessary sources to 'gnufit'
  81.     and do the needed patches to the gnuplot sources. Finally it changes
  82.     the actual working directory.
  83.  
  84.     e.g.    install ~/gnufit
  85.  
  86. 5)  Look at the file 'compile.fit' for compilation hints on your system.
  87.     That may require small changes to the appropriate makefile, e.g. for
  88.     compiler selection and compiler switches.
  89.  
  90. 6)  Check the compilation hints for gnuplot in 'readme.ins' and execute them.
  91.  
  92. GNUFIT has been successfully tested and compiled on the following
  93. operating systems:
  94.  
  95.     DOS (MSC 6.0), OS/2, SunOS, HPUX, IBM/RS6000, DEC Ultrix, DG/UX, LINUX
  96.     Amiga
  97.  
  98. Only the compilers mentioned in 'compile.fit' have been used.
  99. For compatibility purposes with other scripts written for GNUPLOT, the
  100. executables' filenames are still left 'gnuplot', 'gnuplot.exe' etc.
  101. The starting message however distinguishes between GNUPLOT and GNUFIT.
  102. To get a successful compilation on other systems there may be minor patches
  103. to the sources necessary. If you succeed in adding a new platform, please
  104. generate diff's of the modified sources and send them to me. They may be
  105. included into a further release of GNUFIT.
  106.  
  107.  
  108.  
  109. What is planned?
  110. ================
  111.  
  112. This will probably be the last release of GNUFIT. Not because I think it's
  113. rubbish but because it will be included as an internal part into the next 
  114. official release of gnuplot. Development is under way!
  115.  
  116. Please send any comments, bug-reports, implementation reports and
  117. improvement proposals to bug-gnuplot@dartmouth.edu
  118.  
  119. ***************************************************************************
  120.  
  121. Carsten Grammes
  122. Saarbruecker Str. 47
  123. D-66292 Riegelsberg
  124. Germany
  125.  
  126. Internet Mail-Address:        cagr@rz.uni-sb.de
  127. Telephone            49 6897 935 0
  128. Telefax                     49 6897 935 100
  129.  
  130.